home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / pcboard / wall15.zip / WALL.DOC < prev    next >
Text File  |  1996-11-23  |  7KB  |  150 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │ The Wall v1.5  PCBoard PPE                         The Digital Nebula BBS  │
  3. │ Written by Jesse Keene  spacecb@deeptht.armory.com     [408]469∙3604       │
  4. └────────────────────────────────────────────────────────────────────────────┘
  5.  
  6.  INTRODUCTION:
  7.  
  8.   Most of the other "Wall PPE's" that I've seen for PCBoard are one-liners,
  9.   that allow a user to enter a small message among all the other ones users
  10.   have entered.  This Wall takes the idea of "The Wall" much more literally,
  11.   allowing you to write anywhere on the screen and to overwrite what others
  12.   have written.  It has full color support that lets the user change the
  13.   color they're using very easily, and doesn't require the user to know
  14.   how @X color codes work.  This isn't some lousy one-liners PPE, it's more
  15.   of a Full Screen Editor, and it's a 100x's better.
  16.  
  17.   I got the idea from an old Wall door that I saw years ago written for WWIV,
  18.   I thought it was really neat and then years later decided to try and write
  19.   it for my own BBS as a PCBoard PPE.  This is the result ... it has been
  20.   written from scratch, and I've perfected it over the last six months.
  21.  
  22.   This PPE is released as FREEWARE, it's something I wrote in my spare time.
  23.   I've spent Many Hours coding The Wall, so if you find this PPE of any use,
  24.   I would REALLY APPRECIATE hearing from you!!!
  25.  
  26.   You can leave me a message on Salt Air BBS (PCBoard Support BBS) or
  27.   you can email me via the Internet: spacecb@deeptht.armory.com
  28.  
  29.   Also, at the end of the Help File (Ctrl-Z) is a small ad for my BBS,
  30.   please *DO NOT* change this.  I have included the source code because
  31.   whenever I install someone elses PPE, I like to be able to make sure
  32.   there isn't a back door, and make minor changes as necessary.  So I've
  33.   decided to give you that freedom with The Wall - It's also released as
  34.   freeware, and I'm not trying to jack ten bucks out of you like some
  35.   morons try to do for something that took them an hour or less to write,
  36.   so this is the least you can do.
  37.  
  38.         Thanks!!
  39.  
  40.  SYSTEM REQUIREMENTS:
  41.  
  42.   This is a PCBoard PPE, so you must be running PCBoard 15.x to use it.
  43.   It was compiled with PPLC v3.20, so if you are running a version
  44.   of PCBoard earlier than 15.22, you must re-compile the source code.
  45.  
  46.   PPLC unfortunately executes sickeningly slow, and this is a rather
  47.   complex PPE.  Because of this, I suggest that it gets run on a 486/50
  48.   or better - I had some bigs problems with it running slow on a friends
  49.   486sx-33 machine! OH VEY!! (I'm using a Pent/133 so it works fine for me ;)
  50.  
  51.   This PPE uses ANSI codes extensively, so users must have ANSI in order
  52.   to use The Wall.
  53.  
  54.  ────────────────────────────────────────────────────────────────────────────
  55.  
  56.  INSTALLATION:
  57.  
  58.  [1] Unzip this archive into it's own directory (ie, C:\PCB\PPE\WALL)
  59.  [2] Go into PCBSetup | File Locations | Configuration Files
  60.      Edit the CMD.LST file
  61.  [3] Add this PPE:
  62.                           Charges Per     PPE/MNU File Specification -or-
  63.          Command    Sec  Minute    Use    Keystroke Substitution
  64.      ══════════════ ═══ ═════════════════ ═════════════════════════════════
  65.   1) WALL             0        0        0 C:\PCB\PPE\WALL\WALL.PPE
  66.  
  67.  [4] Exit and save,
  68.  [5] Edit your menu, (BRDM, located in C:\PCB\GEN or appropriate directory),
  69.      add the Wall to it somewhere so users know it's a command on your BBS
  70.  
  71.                 Now it's installed !!!
  72.                         Enjoy !!!
  73.  
  74.  TO MAKE THE WALL AVAILABLE WHEN A USER IS LOGGING IN:
  75.  
  76.  [1] Edit the appropriate LOGON file (usually located in C:\PCB\GEN) and
  77.      add the wall in it somewhere, like this:
  78.  
  79. !c:\pcb\ppe\wall\wall.ppe /prompt
  80.  
  81.  [2] Save your LOGON file ...
  82.  
  83.  IF YOU'RE RUNNING A MULTINODE SYSTEM:
  84.  
  85.   You may want to have the PPE lock out other users while someone is using
  86.   The Wall, in order to do this add the "/LOCK" parameter in your CMD.LST
  87.   file, and your LOGON file (if you installed it there).
  88.  
  89.   You should also add the following line to your $$LOGOFF.BAT file to ensure
  90.   that the semaphore file doesn't get left behind:
  91.  
  92.   DEL C:\PCB\PPE\WALL\INUSE.%PCBNODE%
  93.  
  94.  ────────────────────────────────────────────────────────────────────────────
  95.  PARAMETERS:
  96.  
  97.  /PROMPT  - Causes The Wall to prompt the user if they want to tag on it
  98.  /LOCK    - This is for multi-node systems, it locks other users out
  99.             of The Wall while it's in use by another user
  100.  /SAVEPCB - This causes the Wall to get saved in PCBoard format (WALL.PCB)
  101.             when the user exits
  102.  /LOADPCB - Loads WALL.PCB at runtime, saves it on exit
  103.  /SAVEANS - Similar to /SAVEPCB, it saves WALL.ANS, which contains
  104.             ANSI positioning codes
  105.  /LOADANS - Loads WALL.BG and WALL.ANS at runtime, saves WALL.ANS on exit
  106.            
  107.  Commands (Ctrl-A/ESC) for sysops, not listed in help file
  108.   JANITOR - Cleans the Wall
  109.   LASTIN  - Shows last user in Wall
  110.   SAVEPCB - This saves WALL.PCB, if you load this into PCBEdit or display
  111.             it to a user, it looks identical to the Wall at the time it
  112.             was saved.
  113.   VIEWPCB - This lets you view the WALL.PCB file
  114.   SAVEANS - Saves Wall using ANSI positioning codes (WALL.ANS)
  115.   VIEWANS - Views WALL.ANS
  116.  ────────────────────────────────────────────────────────────────────────────
  117.  
  118.  PROGRAM HISTORY
  119.  
  120.         1.0 - 5-18-96 - Initial Release
  121.         1.1 - 6-5-96
  122.             - Added /PROMPT and /LOCK parameters
  123.             - Tab key now works as a Space (so you can space over the wall)
  124.             - Fixed bug where the background color the user was using would
  125.               "bleed" into the position printed at the bottom of the screen
  126.               while they where typing
  127.         1.2 - Beta, Never Released
  128.         1.3 - 9-26-96
  129.             - Added /LOAD and /SAVE parameters
  130.             - Added a Help File, plus many commands
  131.         1.4 - 10-13-96
  132.             - I've refined a lot of the source code
  133.             - added more commands that can be entered via Ctrl-A
  134.             - Hitting ESC Twice (quickly!) acts the same as pressing Ctrl-A
  135.               Hitting ESC Once exits ...
  136.             - Added the ability to save The Wall in PCBoard format (WALL.PCB)
  137.        1.45 - 10-14-96
  138.             - Changed so that Ctrl^Q exits, instead of ESC
  139.               ESC is now for entering a command (same as Ctrl^A)
  140.             - Fixed some bugs I didn't catch before I released v1.4
  141.         1.5 - 11-23-96
  142.             - Added RANDC/RC (Random Color) and RANDP/RP (Random Position)
  143.               commands
  144.             - Added TIME/CLOCK and DATE commands
  145.               TIME will show an active display of the time
  146.               DATE will show the current date
  147.             - Added Diagnal-Up Direction (Ctrl^D),
  148.               and optimized code in Direction function
  149.             - Added (N)umber Pad status with Command prompt
  150.